IRIX Base Documentation 2002 November/SGI IRIX Base Documentation 2002 November.iso/usr/share/catman/p_man/cat3/librw/RWTValMultiSetIterator.z/RWTValMultiSetIterator

Text File | 2002-10-03 | 7.3 KB | 199 lines

RRRRWWWWTTTTVVVVaaaallllMMMMuuuullllttttiiiiSSSSeeeettttIIIItttteeeerrrraaaattttoooorrrr((((3333CCCC++++++++))))                      RRRRWWWWTTTTVVVVaaaallllMMMMuuuullllttttiiiiSSSSeeeettttIIIItttteeeerrrraaaattttoooorrrr((((3333CCCC++++++++))))



NNNNaaaammmmeeee
     RWTValMultiSetIterator<T,C> - Rogue Wave library class

SSSSyyyynnnnooooppppssssiiiissss
              #include<rw/tvmset.h>



              RWTValMultiSet< T,C> vs;
          RWTValMultiSetIterator< T,C> itr(vs);

SSSSttttaaaannnnddddaaaarrrrdddd CCCC++++++++ LLLLiiiibbbbrrrraaaarrrryyyy DDDDeeeeppppeeeennnnddddeeeennnntttt!!!!
     RRRRWWWWTTTTVVVVaaaallllMMMMuuuullllttttiiiiSSSSeeeettttIIIItttteeeerrrraaaattttoooorrrr requires the Standard C++ Library.


DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn
     RRRRWWWWTTTTVVVVaaaallllMMMMuuuullllttttiiiiSSSSeeeettttIIIItttteeeerrrraaaattttoooorrrr is supplied with TTTToooooooollllssss....hhhh++++++++ 7 to provide an
     iterator interface for class RRRRWWWWTTTTVVVVaaaallllMMMMuuuullllttttiiiiSSSSeeeettttIIIItttteeeerrrraaaattttoooorrrr that has backward
     compatibility with the container iterators provided in TTTToooooooollllssss....hhhh++++++++ 6.x. The
     order of iteration over an RRRRWWWWTTTTVVVVaaaallllMMMMuuuullllttttiiiiSSSSeeeetttt is dependent on the supplied
     comparator object parameter C as applied to the values stored in the
     container.  The current item referenced by this iterator is undefined
     after construction or after a call to rrrreeeesssseeeetttt(((()))).  The iterator becomes
     valid after being advanced with either a preincrement or ooooppppeeeerrrraaaattttoooorrrr(((()))).  For
     both ooooppppeeeerrrraaaattttoooorrrr++++++++ and ooooppppeeeerrrraaaattttoooorrrr(((()))), iterating past the last element will
     return a value equivalent to boolean ffffaaaallllsssseeee.  Continued increments will
     return a value equivalent to ffffaaaallllsssseeee until rrrreeeesssseeeetttt(((()))) is called.

PPPPeeeerrrrssssiiiisssstttteeeennnncccceeee
     None

EEEExxxxaaaammmmpppplllleeeessss
              #include<rw/tvmset.h>



              #include<iostream.h>
          #include<rw/cstring.h>
          int main(){
             RWTValMultiSet<RWCString,greater<RWCString> > a;
             RWTValMultiSetIterator<RWCString,greater<RWCString> > itr(a);
             a.insert("John");
             a.insert("Steve");
             a.insert("Mark");
             a.insert("Steve");
             for(;itr();)
               cout << itr.key() << endl;
             return 0;
          }
          Program Output
          Steve
          Steve



                                                                        PPPPaaaaggggeeee 1111






RRRRWWWWTTTTVVVVaaaallllMMMMuuuullllttttiiiiSSSSeeeettttIIIItttteeeerrrraaaattttoooorrrr((((3333CCCC++++++++))))                      RRRRWWWWTTTTVVVVaaaallllMMMMuuuullllttttiiiiSSSSeeeettttIIIItttteeeerrrraaaattttoooorrrr((((3333CCCC++++++++))))



          Mark

PPPPuuuubbbblllliiiicccc CCCCoooonnnnssssttttrrrruuuuccccttttoooorrrrssss
     John



              RRRRWWWWTTTTVVVVaaaallllMMMMuuuullllttttiiiiSSSSeeeettttIIIItttteeeerrrraaaattttoooorrrr<<<<TTTT,,,,CCCC>>>>(RWTValMultiSet< T,C> &h);






     Creates an iterator for the multi-set hhhh.  The iterator begins in an
     undefined state and must be advanced before the first element will be
     accessible

PPPPuuuubbbblllliiiicccc MMMMeeeemmmmbbbbeeeerrrr OOOOppppeeeerrrraaaattttoooorrrrssss
              RWBoolean
          ooooppppeeeerrrraaaattttoooorrrr(((())))();


     Advances sssseeeellllffff to the next element.  If the iterator has advanced past the
     last element in the collection, ffffaaaallllsssseeee will be returned.  Otherwise, ttttrrrruuuueeee
     will be returned.

              RWBoolean
          ooooppppeeeerrrraaaattttoooorrrr++++++++();


     Advances sssseeeellllffff to the next element.  If the iterator has been reset or
     just created sssseeeellllffff will now reference the first element.  If, before
     iteration, sssseeeellllffff referenced the last association in the multi-set, sssseeeellllffff
     will now reference an undefined value and ffffaaaallllsssseeee will be returned.
     Otherwise, ttttrrrruuuueeee is returned. Note: no postincrement operator is provided.

PPPPuuuubbbblllliiiicccc MMMMeeeemmmmbbbbeeeerrrr FFFFuuuunnnnccccttttiiiioooonnnnssss
              RWTValMultiSet<T,C>*
          ccccoooonnnnttttaaaaiiiinnnneeeerrrr(((()))) const;


     Returns a pointer to the collection being iterated over.

              T
          kkkkeeeeyyyy();


     Returns the value pointed to by sssseeeellllffff.






                                                                        PPPPaaaaggggeeee 2222






RRRRWWWWTTTTVVVVaaaallllMMMMuuuullllttttiiiiSSSSeeeettttIIIItttteeeerrrraaaattttoooorrrr((((3333CCCC++++++++))))                      RRRRWWWWTTTTVVVVaaaallllMMMMuuuullllttttiiiiSSSSeeeettttIIIItttteeeerrrraaaattttoooorrrr((((3333CCCC++++++++))))



              void
          rrrreeeesssseeeetttt();
          void
          rrrreeeesssseeeetttt(RWTValMultiSet<T,C>& h);


     Resets the iterator so that after being advanced it will point to the
     first element of the collection.  Using rrrreeeesssseeeetttt(((()))) with no argument will
     reset the iterator on the current container.  Supplying a RRRRWWWWTTTTVVVVaaaallllMMMMuuuullllttttiiiiSSSSeeeetttt
     to rrrreeeesssseeeetttt(((()))) will reset the iterator on that container.













































                                                                        PPPPaaaaggggeeee 3333